Skip to content

Add storage policy documentation#414

Merged
glasstiger merged 20 commits intomainfrom
ia_auto_parquet
Apr 23, 2026
Merged

Add storage policy documentation#414
glasstiger merged 20 commits intomainfrom
ia_auto_parquet

Conversation

@glasstiger
Copy link
Copy Markdown
Contributor

@glasstiger glasstiger commented Apr 10, 2026 •
edited
Loading

Summary

  • Add new Storage Policy concept page (concepts/storage-policy.md) documenting the Enterprise feature for automated partition lifecycle management (convert to Parquet, drop native, drop local, drop remote)
  • Add new ALTER TABLE SET STORAGE POLICY SQL reference page (query/sql/alter-table-set-storage-policy.md) with full syntax, constraints, permissions, and examples
  • Add STORAGE POLICY clause documentation to the CREATE TABLE reference page
  • Update data-retention.md to list storage policies as a third retention approach alongside TTL and manual DROP PARTITION
  • Update storage-engine.md to reference storage policies for automatic Parquet conversion (replacing the previous object storage mention)
  • Add cross-reference from TTL concept page to the new storage policy docs
  • Register both new pages in sidebars.js

Test plan

  • Verify yarn build succeeds with no broken links
  • Check sidebar navigation includes the new pages under Concepts and SQL Reference
  • Confirm cross-links between storage policy, TTL, data retention, and CREATE TABLE pages resolve correctly

🤖 Generated with Claude Code

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 10, 2026 •
edited
Loading

🚀 Build success!

Latest successful preview: https://preview-414--questdb-documentation.netlify.app/docs/

Commit SHA: f3c2324

📦 Build generates a preview & updates link on each commit.

glasstiger and others added 11 commits April 10, 2026 12:29
@glasstiger
update RBAC page
b36aaec
@glasstiger
add mat view syntax
269627b
@glasstiger @claude
improve storage policy configuration docs
df6ec48 
Use human-readable time suffixes for config defaults instead of raw
microsecond values. Add note that time-suffixed values are accepted.
Add worker.affinity and worker.sleep.timeout to the config table.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@glasstiger
update config docs
c1cccc0
@glasstiger
Merge branch 'main' into ia_auto_parquet
63f93e1
@glasstiger
Merge branch 'main' into ia_auto_parquet
71754a0
@glasstiger
Merge branch 'main' into ia_auto_parquet
5096028
@glasstiger
Merge branch 'main' into ia_auto_parquet
8303855
@glasstiger
update config docs
b9af9e6
@glasstiger
update config docs
13eeae7
@glasstiger
Merge branch 'main' into ia_auto_parquet
e81a22d
RaphDal
RaphDal reviewed Apr 17, 2026
View reviewed changes
Comment thread documentation/concepts/storage-policy.md Outdated
javier
javier requested changes Apr 21, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@javier javier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice docs, but I think we need to change a few things

Comment thread documentation/query/sql/alter-table-set-storage-policy.md Outdated
Comment thread documentation/concepts/storage-policy.md
Comment thread documentation/query/sql/create-mat-view.md
Comment thread documentation/query/sql/create-mat-view.md
Comment thread documentation/query/sql/create-table.md
Comment thread documentation/query/sql/create-table.md Outdated
Comment thread documentation/query/sql/create-mat-view.md Outdated
@javier
Copy link
Copy Markdown
Contributor

javier commented Apr 22, 2026

We should also add some section about this to the enterprise quickstart page https://questdb.com/docs/getting-started/enterprise-quick-start.

And make sure the reference for /docs/concepts/ttl/ and for alter table SET TTL mention in enterprise this is not supported anymore, and has been superseded by storrage policies

@glasstiger
Copy link
Copy Markdown
Contributor Author

glasstiger commented Apr 22, 2026

We should also add some section about this to the enterprise quickstart page https://questdb.com/docs/getting-started/enterprise-quick-start.

And make sure the reference for /docs/concepts/ttl/ and for alter table SET TTL mention in enterprise this is not supported anymore, and has been superseded by storrage policies

done

glasstiger and others added 2 commits April 22, 2026 20:19
@glasstiger
address review comments
cf15d3d
@bluestreak01 @claude
address review comments
f3c2324 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
bluestreak01
bluestreak01 approved these changes Apr 23, 2026
View reviewed changes
Copy link
Copy Markdown
Member

@bluestreak01 bluestreak01 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM — documentation placement, cross-references, and information flow for humans/LLMs all look solid.

@glasstiger glasstiger merged commit 80538c7 into main Apr 23, 2026
3 checks passed
@glasstiger glasstiger deleted the ia_auto_parquet branch April 23, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@RaphDal RaphDal RaphDal left review comments

@javier javier javier approved these changes

@bluestreak01 bluestreak01 bluestreak01 approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@glasstiger @javier @bluestreak01 @RaphDal